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1. INTRODUCTION 



AP800 is a symbolic assembly program for the MICRO 800 computer. The assembler 
provides for symbolic addressing and mnemonics for machine and assembler instructions. 
This program is written in FORTRAN IV and may be adapted to many computer systems. 
The MICRO 800 source program is entered by punch cards and the output of the assembler 
includes an assembly Hsting, read only storage diode map, and an object program card deck. 

The AP800 assembly language includes the following features: 

Address Arithmetic - Decimal and hexadecimal numbers, symbolic addresses, and 

arithmetic expressions. 

Listing Control - The format of the listing which may be controlled with 

comment cards included. 

Diagnostics - Diagnostics for source program errors included in the output 

listing. 

Option Flags Single letter flags to signify options to micro-commands. 



2. SOURCE LANGUAGE 



The source language is a sequence of symbolic instructions, called statements, which are 
punched on cards. Each statement is punched on a single card. Each statement may consist 
of from one to four entries: a name field, an operation field, an operand field, and a 
comment field. Columns 73-80 are normally used for identification or sequence numbers. 
Entries in the operand field are expressions which may consist of decimal numbers, 
hexadecimal numbers, and symbolic values. 



STATEMENT FORMAT 



Name Field 



The name field entry is a symbol composed of from one to six characters starting with 
column 1 and terminating with the first blank. The first character of a symbol is alphabetic 
or period; subsequent characters may be alphabetic, numeric or a period. A name entry is 
usually optional and the type of instruction determines the legal content of the name field. 
The symbol takes on the current value of the assembler's location counter unless assigned 
another value by an assembler instruction. When an asterisk (*) appears in column 1 the 
remainder of the line is considered as comment and is not processed by the assembler except 
to place it on the listing. 

Operation Field 

The operation field entry is a mnemonic operation code specifying the machine or assembler 
instruction. The field begins in column 8 and is terminated by the first blank. Certain 
memory referencing instruction modes use special symbols suffixed to the mnemonic. 

Operand Field 

The operand field entries identify and describe data to be acted upon by instructions as, for 
example, memory locations, or literals. One or more operands may be written, depending on 
the needs of the instruction. Entries are separated by commas, and no blanks may appear in 
the field. The operand field starts in column 14. It is terminated by the first blank column. 

Comments Field 

Comments describing the information about the program may be inserted between the end 
of the operand field and column 72. All characters, including spaces, may be used in writing 
a comment. 



OPERAND FIELD EXPRESSIONS 

Expressions in the operand field are made up of one or more terms which are connected by 
+ and - arithmetic operators. No parenthetical expressions are allowed. Each term of the 



expression represents a value. Values may be assigned by the assembler program (symbols), 
or there may be inherent in the term itself (constants). The range of values depends on the 
operand and the instruction. Address expressions for relative type addressing are written as 
if they are not relative. The assembler will convert these expressions to a relative 
displacement. 

Symbols 

A symbol is composed of one to six characters. The first character must be alphabetic or 
period; subsequent characters may be numeric, alphabetic, or period. Imbedded blanks are 
not allowed and the assembler stops scanning the symbol with the first character which is 
not alphanumeric or a period. All symbols, except the special symbols * and **, used in an 
operand field, must be defined by a single appearance in the name field of statement withm 
the program. 

Special Symbols 

The special symbol * represents the momentary value of the assembler's location counter. It 
may be used as any other symbol in an expression but must never appear in the name field. 
When used in the operand field of a multi-byte instruction it will assume the value of the 
address of the first byte of the instruction. 

Constants 

The values of the constant terms are not assigned by the assembler program but are inherent 
in the terms. There are two types of constant terms: decimal and hexadecimal. 

a. Decimal Constant 

A decimal constant is an unsigned decimal number. The value must be less than 
65,536. 

b. Hexadecimal Constant 

A hexadecimal constant is an unsigned hexadecimal number of up to four 
characters written as a sequence of hexadecimal digits. The digits are enclosed in 
single quotation marks and preceded by the letter X. Each hexadecimal digit 
represents a four-bit binary number. The characters A through F are used to 
identify the hexadecimal integers 10 through 15. 



3. MACHINE COMMANDS 



Machine commands are expressed by a one or two character mnemonic code in the 
operation field. The required operands depend on the command type. The four syntax types 
are described below. Examples of the method of writing machine commands in the assembly 
language are shown in the sample hsting in section 5. 



Load Register Commands (Command 1) 

All commands of this syntax type have two character mnemonics beginning with L, except 
for the Jump Command (JP). The second character is the register identifier character. The 
operand field of all commands of this type except Jump must contain a single operand 
which is an expression, whose value is less than 1024 and greater or equal to -256. It is 
evaluated modulo 256. The Jump command must contain an operand expression which has 
a positive value less than 1 024. 



Literal-File Commands 

The commands of this syntax group (commands 2-6), have two character mnemonics and 
require two operands. The first operand is an expression which designates a file register (f) 
and must be in the range 0-15. The second operand (n) is an expression which must be less 
than 1024 and greater than or equal to -256. It is evaluted modulo 256. 



Execute and Control Commands 

The commands of this syntax group have operation code mnemonics identical to those of 
the next group, and require two operands. The first operand is an expression which 
designates a file register (f) and must be in the range 0-15. The second operand (c) is an 
expression which designates the option bits (7-4) and must be in the range 0-15. 



Operate Class Commands other than Execute and Control 

The commands of this syntax group have basic operation code mnemonics which are a single 
character. If the result of the operation is to be routed to a machine register the designator 
of that register is appended as a second character of the mnemonic. If the result is not to be 
placed in the designated file register, an * is appended to the mnemonic. The second 
character register designators are given in the table shown on the next page. 



Register 
Code 


Register 
Designator 







1 


T 


2 


M 


3 


N 


4 


L 


5 


K 


6 


U 


7 


S 



Register 



None 



T Register 

M Register 

N Register 

L Register: addresses 000-OFF and 200-2FF 

L Register: addresses 100-1 FF and 300-3FF 

U Register 

OR U Register into bits 15-8 of 
command (except Control commands) 



The first operand is an expression which designates a file register (f) and must be in the 
range 0-15. Other operands are optional and if included, each consists of a single character 
which designates an option for the command. The allowable option flags for each command 
are given on the table on the next page and the meaning of each is given below. The order of 
writing the options is immaterial. 



L 


- Link Control 


I 


- Add one or insert one on shift 


D 


- Decrement one 


T 


- T register for operand 


F 


— Complement of T register for operand 


H 


- Half Cycle memory operation 
(otherwise full cycle) 


R 


" Right shift (otherwise left shift) 


C 


— Set condition flags 



MICROCOMMANDS 



Command 



LoadT 

Load M 

Load N 

LoadU 

Load Zero Control 

Load Seven Control 
Jump 

Load File 

Add to File 

Test If Zero 

Test If Not Zero 

Compare 

Execute 

Control 

Add 

Increment 

Subtract 

Decrement 

Copy 

Read 

Write 

Logical OR 

Move 

Exclusive-OR 

Logical AND 

Shift 



Mnemonic 


Operand Field 


LT 


n 


LM 


n 


LN 


n 


LU 


n 


LZ 


n 


LS 


n 


JP 


n 


LF 


f,n 


AF 


f,n 


TZ 


f,n 


TN 


f,n 


CP 


f,n 


Er* 


f,c 


Kr* 


f,c 


Ar* 


f,L,l,T,C 


Ir* 


f,L,C 


Sr* 


f,L,DJ,C 


Dr* 


f,L,C 


Cr* 


f,L,l,T,C 


Rr* 


f,L,l,D,H 


Wr* 


f,L,l,D,H 


Or* 


f,L,F,T,C 


Mr* 


f,L,C 


Xr* 


f,L,F,T,C 


Nr» 


f,L,F,T,C 


Hr* 


f,L,l,R,C 



4. ASSEMBLER INSTRUCTIONS 



Seven assembler instructions are included for control of the assembly process and the 
output listing. 



ORG 



Set Location Counter 



The ORG assembler instruction alters the setting of the location counter. 
The name field entry, if any, will be assigned the value of the program 
counter after it is altered. The operand field of ORG must contain an 
expression whose value will be placed in the location counter. All symbols in 
the expression must have been previously defined when the instruction is 
first encountered. The next instruction which places object code in the 
program is forced to begin a new object card. 



EQU 



Equate Symbol 

The EQU assembler instruction is used to define a symbol by assigning to it 
the value of the operand field. Any symbols appearing in the expression 
must have been previously defined when the instruction is first encountered. 
A name field entry must be present. 



DC 



Define Constant 



The DC assembler instruction is used to provide constant data in memory. 
Each statement specified only one constant. The constant is written as an 
expression and is assembled as a 16-bit word in storage. 



IDENT - Program Identification 

The IDENT assembler instruction is used to identify the start of a program 
and to supply the program name which is located in the operand field. The 
IDENT must be the first statement in a source program. 



END 



End Assembly 

The END assembler instruction terminates the assembly of a program and 
must be the last statement in a source program. 



SPACE - Space Listing 



The SPACE assembler instruction causes one or more blank lines to be 
inserted into the listing. The name field is disregarded by the assembler. The 
operand field contains an expression specifying the number of blank lines. If 
the spacing is beyond the end of the current page, the listing begins at the 
top of the next page. 



EJECT - Start New Listing Page 



The EJECT instruction causes the next line of the listing to appear at the top 
of the next page. The name and operand fields are disregarded by the 
assembler. 
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5. ASSEMBLY LISTING AND DIODE MAP 



The output listing from AP800 contains the memory address, and contents of words in the 
object program. The source statement is printed side-by-side with the object code. 

FORMAT 



Printer Columns 

8- 11 
15- 17 
21 -24 
31 - 110 



Contents 

Error flags 
Storage address 
Storage contents 
Source statement 



A — Address Error 



ERROR FLAGS 



This error occurs when an address expression in the operand field is incorrectly 
written or the value is out of range for one of the operands. An error flag will 
occur for each operand in error or out of range. 

Flag Error 

This error occurs when an operate class command has an option flag in the 
operand field which is not allowed for the command or is unrecognizable. 



M 



N 



O 



u 



Multidefined Symbol Error 

This error occurs when the symbol in the name field has been previously defined 
by appearing in the name field of another instruction. 

Name Field Error 

This error flag occurs when the symbol in the name field starts with a character 
other than alphabetic or period, or contains a non alphanumeric or non period 
character. 

Operation Mnemonic Error 

This error occurs when the assembler does not recognize the contents of the 
operation field starting in column 8. A zero value is assembled to allow patching. 

Undefined Symbol Error 

This error occurs when the symbol encountered in an expression of the operand 
field is not defined by an appearance in the name field. 
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SAMPLE LISTING 

The sample listing on the next page shows the format of the listing and provides examples of 
how to write each instruction type, literals, constants, and assembler instructions. The six 
types of error conditions are also illustrated. 

DIODE MAP 

The read only storage diode map is printed if the control card followirfg the END card 
contains a 1, 2, or 3 in column 1. The digit specifies the number of diode maps to be 
printed. The diode map for each 256 word read only storage board is placed on three pages 
of the assembly listing. The format of the map is the same as the physical layout of the ROS 
board. An X on the map indicates a 1-bit and that a diode is to be placed at the position of 
the X, while an indicates a 0-bit and no diode. 

Each of the 64 lines of the diode map for a board contains the diodes for four words. The 
address of the first word is printed at the left of the map. The four words are interleaved so 
that the same bit position in each of the four words are grouped together and printed as a 
cluster at four diode positions. The 1 6 bit positions are printed across the page and the sum 
of the number of diodes on the line is placed at the right of the map. 
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000 
001 
002 
001 
004 
005 

006 
007 

loo 

101 
102 
103 

l"* 
105 
106 
107 

loa 
los 

IPA 
IPB 

mc 
mo 

lOE 
lOF 
110 

111 

112 
113 
114 
115 
116 
117 

lie 

119 

u« 

lie 
nc 

110 

HE 

UF 
120 
121 
122 
123 
124 



200 
300 



1112 
1204 
13"H 
16AA 
16f;A 
1780 

1408 
1400 

1502 

ICO 2 
10'' 2 
0000 

2aFF 
2200 

2A(<2 
3202 
4004 
5A('C 
65FE 

0250 
7580 
82P0 
8200 
V2Fi) 

<?2U0 
82F5 
A260 
A260 
A27o 
C2FQ 
C2'''0 

U2F0 
E2F0 

F2P0 

CAOI 
854B 
C518 
B069 
8543 
8A23 

8224 
8245 
8541 
0500 
OOOA 

lOA" 
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lOENT SAMPLE 
• THIS SAMPLE PR06HAM SHOWS MO* TO WHITE VARIOUS COMMANDS. 

*• LOAD HEGISTEH COMMANDS 



START LT 
LM 
LN 
LU 

123456 L'J 
tS 



X#12# 

4 

ALPHA*2 

X#AA# 

XttA)> 

X#80# 



•♦ JUMP COMMANDS 



- HEXAOECIMAL LITERAL 

- DECIMAL LITERAL 
. EXPRESSION LITERAL 

IN NAME flELO IS ILLEGAL 

Halt 



LOAD T 
LOAD M 
LOAD M 
LOAD U 
SYMBOL 
LOAD SEVEN CONTROL 



ALPHA 



PAGEl 



JP 

JP 

ORG 

JP 

JP 

JP 

PP 



•♦2 

SAM 
256 
• *Z 

PA(5E2*2 
PAGE3*2 
2*2 



•♦ FILE LITERAL COMMANDS 



LF 
LF 
LF 
AF 
H 
Tn 

CP 



10»X*FF* 

2 

TEN, 2 

2,2 

0,4 

ten»x#c* 

5,-2 



•• OPERATE COMMANDS WITH 



OPER 



E 

K 
A 
I 
S 
D 
C 
R 
R 
tl 

M 
X 
N 
H 



2»5 

5,8 

2,L,I,T,C 

2,L,C 

2,L,D»T,C 

2,L,C 

2fL»ItT,C 

2,L»0,H 

2«L,I,0,H 

2,L,ItO»H 

2,LfF»T»C 

2,L,C 

2tL«F»T»C 
2,L»F,T»C 
2,L,I,RiC 



JUMP IN PAGE ZERO 

SYMBOL UNDEFINEO 

0H6 ASSEMBLER INSTRUCTION > RAGE 1 

JUMP IN PAGE 1 

JUMP TO PAGE 2 

JUMP TO PAGE 3 

OPERATION MNEMONIC IS ILLEGAL 

LOAD FILE • HEXADECIMAL L|TERaL 

error in operand field 
luao file - decimal literal 
add to file 
test if zero 
Test if not zzm 
compare - negative operand ok 
legal option flags 

EXECUTE 
CONTROL 
ADD . LINK, INCH, I RECi, COND FLAG 



INCREMENT 

SUBTRACT - 

DtCREHENT 

COPY 

RkAO MEMORY 

HEAD MEMORY 

WMITE MEMORY 

OH 

MOVE 



FORM OF ADD 
LlNK,OECR,T HEG«COND FLAG 
FORM OF SUBTRACT 



. LINK 

- l or i or d, half 

- l or i or 0, half 
link,comp t reg, thue t reg, cond 

. link,cOnd flag 



»• VARIATIONS OF OPEHaTE 
MT TEN 

IN» 



TEN 

PAfiEz 

PA6E3 



M» 

ct* 

IN 

AM 

On» 

AL 

IK 

IT 

E 

EQU 

ORG 

UC 

ORG 

JP 

END 



5 

5,C 
0,T,I 

5 

TEN.T 

11 

2»T 

2 

s,x 

5»L 

10 

X^200^ 

X^10AH# 

X*300* 

OPER 



EACLUSIVE-OR 
AND 

SHIFT • LINKtONE, RIGHT, COND FLAG 
COMMANDS 

MOVE FILE REG 10 TO T 
• PREVENTS RESULT FROM GOING To FILE 
FILE 5 IS TESTtO AND COND FLAGS SET 
THis COMMAND INCREMENTS THE T REG 
INCREMENT FILE «E6 5 AND PLACE IN N REG 
FILE DESIGNATOR MAY BE EXPRESSION 
FILE 11 MINUS ONE IS PLACED In N REG 

jump in page or 2 

jump in page 1 or 3 

illegal flag 

no flags on execute oh control 

0m6 for page 2 

Command maDE by Constant 

org for page 3 

last card 



FIGURE 1. SAMPLE LISTING 
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6. OBJECT PROGRAM CARD DECK 



The AP800 assembly program generates a deck of cards which contain the binary object 
code. All information punched on the cards is in Hollerith code, with a single hexadecimal 
digit (four binary bits) punch in each column. This format allows easy visual reading of the 
cards after they are interpreted and permits rapid patching or generation of patches to the 
deck. Each card contains 16 program words. If all 16 words are zero, the card is not 
punched. 

The cards have two fields as follows: 

Columns 1-4 — Load address 

Columns 5-68 - Object code, four columns per word 
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